home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / tls / tls086.decalpha.ltr < prev    next >
Text File  |  1995-07-20  |  6KB  |  194 lines
  1. IXI Visual Tcl
  2. ==============
  3.  
  4. Welcome to IXI Visual Tcl 1.0C1 for 
  5. DEC OSF/1 (Digital UNIX) for Alpha
  6.  
  7.  
  8. DESCRIPTION
  9. ===========
  10.  
  11. IXI Visual Tcl is a high-level graphical scripting language for graphical
  12. terminals. IXI Visual Tcl interprets commands and constructs graphical output
  13. using Motif, allowing the production of sophisticated graphical applications
  14. without the complexity of Motif.
  15.  
  16. IXI Visual Tcl is a multi-platform port of SCO Visual Tcl.
  17.  
  18.         
  19. INSTALLATION
  20. ============
  21.  
  22. To install IXI Visual Tcl, do the following:
  23.     
  24. 1. Choose a directory in which to install IXI Visual Tcl. The
  25.    recommended location is /opt, although you may choose a different
  26.    location if you wish. Move to this directory by typing:
  27.  
  28.       cd /opt
  29.  
  30. 2. After uncompressing, extract the software by typing the following:
  31.        
  32.     OSF/1 for Alpha:    tar xvf cdromdir/tls085.decalpha
  33.  
  34.     GENERIC IXI VISUAL TCL DOC:
  35.         tar xvf cdromdir/tls085.ixidoc
  36.  
  37.    replacing cdromdir with the name of your mount directory. See the
  38.    IXI Premier Motif Installation & Release notes for more information.
  39.  
  40. CONFIGURATION
  41. =============
  42.  
  43. If you installed IXI Visual Tcl in the recommended location, IXI Premier Motif
  44. configures all the appropriate environment variables automatically.
  45.  
  46. If you installed IXI Visual Tcl in a different location, you should do the
  47. following to correctly configure your system, replacing tcl_dir with the 
  48. pathname of the directory in which you installed IXI Visual Tcl:
  49.  
  50. 1. Add the bin directory to your PATH environment variable by typing one 
  51.    of the following:
  52.  
  53.     Bourne shell: PATH=tcl_dir/IXIvt10s/bin:$PATH ; export PATH
  54.     C shell:      setenv PATH tcl_dir/IXIvt10s/bin:$PATH
  55.  
  56. 2. Set the VTCL_HOME environment variable by typing one of the following:
  57.  
  58.     Bourne shell: VTCL_HOME=tcl_dir/IXIvt10s/lib/vtcl ; export VTCL_HOME
  59.     C shell:      setenv VTCL_HOME tcl_dir/IXIvt10s/lib/vtcl
  60.  
  61. 3. The remaining environment variables needed by IXI Visual Tcl can now
  62.    be set automatically by typing one of the following:
  63.     
  64.     Bourne shell: . $VTCL_HOME/sh-env
  65.     C shell:      source $VTCL_HOME/csh-env
  66.  
  67. TESTING 
  68. =======
  69.  
  70. A number of test scripts are provided to test every aspect of IXI Visual Tcl.
  71. These are located in $VTCL_HOME/tests. To run a test, do the following:
  72.  
  73. 1. Move to the tests directory by typing the following:
  74.     
  75.     cd $VTCL_HOME/tests
  76.  
  77. 2. Run the test suite program by typing the following:
  78.  
  79.     vtcl Browse.tcl
  80.  
  81. 3. You are presented with a list of test scripts. To view a test script,
  82.    click on its name in the list. To run a script, click on the Execute...
  83.    button. To quit the test suite, click on the Close button.
  84.  
  85. DEMOS
  86. =====
  87.  
  88. Demonstration programs are located in $VTCL_HOME/examples. To run a 
  89. demonstration program, do the following:
  90.  
  91. 1. Move to the examples directory by typing the following:
  92.     
  93.     cd $VTCL_HOME/examples
  94.  
  95. 2. Run the appropriate program by typing
  96.  
  97.     vtcl demo_name
  98.  
  99.    replacing demo_name with the filename of the demonstration program you 
  100.    wish to run.
  101.  
  102.  
  103. DOCUMENTATION
  104. =============
  105.  
  106. Documentation is provided in HTML format for viewing with IXI
  107. Mosaic. The documentation for IXI Visual Tcl appears as an entry in
  108. your Book List.
  109.  
  110. SUPPORT
  111. =======
  112.  
  113. All problems may be reported to IXI either by using the problem report form:
  114.  
  115.     http://www.ixi.com/support/bugreport.html
  116.  
  117. or by sending email to:
  118.  
  119.     support@x.co.uk
  120.  
  121. Please note however that IXI Visual Tcl is not a supported product.
  122.  
  123. IXI Visual Tcl HOME PAGE
  124. ========================
  125.  
  126. For up-to-date, complete information on IXI Visual Tcl, refer to 
  127. the IXI Visual Tcl home page:
  128.  
  129.     http://www.ixi.com/devt/vtcl/cover.html
  130.  
  131. or SCO Visual Tcl home page:
  132.  
  133.     http://www.sco.com/Products/vtcl/vtcl.html
  134.  
  135. Visual Tcl 1.0C1 RELEASE NOTES
  136. ==============================
  137.  
  138. 1) SunOS 4.1.x and Solaris 2.x:
  139.  
  140.     * There is no character based display engine.  Please ignore
  141.       all references to CHARM, and/or character display server in
  142.       the documentation.
  143.  
  144.     * There is no Help support available, except for Help ON_VERSION.
  145.  
  146.     * The dialog box options -apply and -cancel are only available for
  147.       VtFormDialog and VtFileSelectionDialog.
  148.  
  149.     * If for any reason Visual Tcl hangs, you may need to kill the daemon
  150.       server process and restart your application. This 
  151.       also terminates all current vtcl applications connected to the 
  152.       server.  To kill the daemon server process, do the following:
  153.  
  154.       1. To discover the process ID number of the daemon, type 
  155.          one of the following:
  156.  
  157.           Solaris: ps -elf | grep xm_vtcld
  158.           SunOS:   ps -aux | grep xm_vtcld
  159.  
  160.       2. Kill the process by typing the following:
  161.  
  162.         kill -9 pid
  163.         
  164.          replacing pid with the process ID returned by step 1.
  165.  
  166.  
  167. 2) SunOS 4.1.x only:
  168.     
  169.     * SunOS limits the number of IXI Visual Tcl shells that can be
  170.       run concurrently to 5. To run more shells concurrently, you
  171.       must increase the value of FIFOCNT and rebuild the
  172.       kernel. You should install patch number 100347 before
  173.       attempting to do this.
  174.  
  175.     * Problems may occur under SunOS if you do not exit your IXI
  176.       Visual Tcl shell cleanly. The VtClose command should always be used 
  177.       to exit a shell. Do not attempt to exit a Visual Tcl
  178.       application by sending signals such as SIGKILL or SIGSTOP.
  179.  
  180.       If for some reason you must terminate a script using a 
  181.           process ID, do the following:
  182.  
  183.       1. Identify the process by typing:
  184.  
  185.         ps -aux | grep vtcl
  186.  
  187.       2. Kill the process by typing:
  188.  
  189.         kill pid
  190.  
  191.          replacing pid with the process ID returned by step 1.
  192.          Note that you should not use `kill -9', as this may
  193.              hang the IXI Visual Tcl server.
  194.